<!--
  ~ Copyright (C) 2010 Brockmann Consult GmbH (info@brockmann-consult.de)
  ~
  ~ This program is free software; you can redistribute it and/or modify it
  ~ under the terms of the GNU General Public License as published by the Free
  ~ Software Foundation; either version 3 of the License, or (at your option)
  ~ any later version.
  ~ This program is distributed in the hope that it will be useful, but WITHOUT
  ~ ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  ~ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  ~ more details.
  ~
  ~ You should have received a copy of the GNU General Public License along
  ~ with this program; if not, see http://www.gnu.org/licenses/
  -->

<html>
<head>
    <title>Sentinel Toolbox Help - GCP Management</title>
    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    <link rel="stylesheet" href="../style.css">
</head>

<body>
<table class="header">
    <tr class="header">
        <td class="header">&nbsp;
            GCP Management
        </td>
        <td class="header" align="right"><a href="../general/overview/SnapOverview.html"><img src="../images/snap_header.jpg"
                                                                                     border="0"></a></td>
    </tr>
</table>

<h4>GCP Management in the Sentinel Toolbox</h4>

<p>
    A GCP is a marker for a certain geographical position within a geo-referenced image.
    The properties of a GCP are
<ul>
    <li>the geographical co-ordinate,</li>
    <li>a graphical symbol,</li>
    <li>the name (label),</li>
    <li>and a textual description.</li>
</ul>
<p>
    In contrast to a pin a GCP is fixed to a geographical position. It can be set to a different image location in 
    order to create a <a href="#gcpGeoCoding">GCP geo-coding</a> for a product or improve an existing
    geo-coding or define a new one.
</p>

<p>
    GCPs are displayed as symbols at their geographical positions in image views associated
    with the current product. GCPs are stored in the current product and available again if the
    product is re-opened.<br>

    New GCPs can be created with the <a href="#gcpTool">GCP Tool</a>
    It is also possible to create and remove GCPs by using the <a href="#gcpManager">GCP Manager</a>.


<p>
    <a name="gcpTool"><b>The GCP Tool &nbsp;&nbsp;</b></a><img src="images/icons/GcpTool24.gif"><br/>
    The GCP Tool is used to create a new GCP. If the GCP Tool is active, a click into an image view
    creates a new GCP at the current cursor position.<br>
    <a name="selectTool"><b>The Select Tool &nbsp;&nbsp;</b></a><img src="images/icons/SelectTool24.gif"><br/>
    Selecting existing GCPs can be done with the Select Tool. If you click on an existing GCP with the Select Tool
    it becomes the selected GCP. If you double-click on an existing GCP the <a href="#editGcpDialog">Edit GCP</a> dialog appears
    and lets you edit the properties of the selected GCP.


<h4><a name="gcpManager">The GCP Manager &nbsp;&nbsp;</a><img src="images/icons/GcpManager24.gif"></h4>

<p>
    The GCP manager is used to display all GCPs stored in the current product within a
    table and provides some GCP related operations.

<p align="center"><img src="images/GcpManager.png"></p>

<p>
    If you click on a GCP within the table it becomes the selected GCP.
    Double-clicking on GCP in the table opens the <a href="#editGcpDialog">Edit GCP</a>.
    You can also change the values for <code>X, Y , Lat and Lon</code> of the GCP, by editing the table cells directly. 
</p>

<p>In the following the tool buttons of the GCP manager are explained.</p>

<table cellpadding=2 cellspacing=0 border=0>
    <tr>
        <td><img src="images/icons/New24.gif"></td>
        <td>Creates a new GCP and adds it to the product.</td>
    </tr>
    <tr>
        <td><img src="images/icons/Copy24.gif"></td>
        <td>Creates a new GCP by cloning the selected GCP.</td>
    </tr>
    <tr>
        <td><img src="images/icons/Edit24.gif"></td>
        <td>Opens the edit dialog for the selected GCP.</td>
    </tr>
    <tr>
        <td><img src="images/icons/Remove24.gif"></td>
        <td>Removes the selected GCP from the current product.</td>
    </tr>
    <tr>
        <td><img src="images/icons/Import24.gif"></td>
        <td>Imports a single GCP from a flat text or XML file.</td>
    </tr>
    <tr>
        <td><img src="images/icons/Export24.gif"></td>
        <td>Exports a single GCP to an XML file.</td>
    </tr>
    <tr>
        <td><img src="images/icons/MultiAssignProducts24.gif"></td>
        <td>Transfers the selected GCP to one or more other products.</td>
    </tr>
    <tr>
        <td><img src="images/icons/Filter24.gif"></td>
        <td>Enables the expansion of the table with pixel values.</td>
    </tr>
    <tr>
        <td><img src="images/icons/ExportTable.gif"></td>
        <td>Exports all values of the displayed table to a flat text
            file.
            The exported text is tabulator-separated and may therefore be import directly into a spreadsheet application
            (e.g. MS Excel).
        </td>
    </tr>
    <tr>
        <td><img src="images/icons/ZoomTo24.gif"></td>
        <td>Centers the image view on the selected GCP.</td>
    </tr>

</table>

<h4><a name="editGcpDialog">The Edit GCP Dialog</a></h4>

<p>
    The 'Edit GCP' dialog is used to edit the properties of a GCP after a new GCP has been created or after a
    selected GCP has been double-clicked. This dialog is also available in the GCP manager.

<p align="center"><img src="images/GcpEditor.png"></p>

<p>The editable GCP properties are
<ul>
    <li>the geographical co-ordinate, which can also been given as pixel position</li>
    <li>the name for the GCP</li>
    <li>and a textual description.</li>
</ul>

<h4><a name="gcpGeoCoding">GCP Geo-Coding</a></h4>
<p>
    This geo-coding calculated by using the defined GCPs as reference points and the given polynomial method type.
    You can choose between the <code>linear, quadratic or a cubic</code> polynomial method.
    The <code>status</code> field below the polynomial method chooser shows you if you already have enough GCPs
    defined for the currently chosen method or if the geo-coding is already attached to the product.<br>
    On the lower left hand side information about the currently attached GCP geo-coding is displayed.
    It shows the used polynomial method and the overall <code>RMSE</code> for the latitudes and longitudes.
    In the table you can see the deviation (<code>Delta Lat</code> and <code>Delta Lon</code>) for each GCP from the
    given to the calculated geo-position.
    If you attach a GCP geo-coding to the product the former geo-coding is preserved and restored if you detached
    the GCP geo-coding.
</p>

<hr>
</body>
</html>